home *** CD-ROM | disk | FTP | other *** search
/ Shareware Game Pak / Shareware Game Pak For Windows.iso / csbt / csbt.doc < prev    next >
Text File  |  1993-02-02  |  16KB  |  440 lines

  1.                             CardShark Bridge Tutor
  2.                           Copyright 1993 Nelson Ford
  3.  
  4.  
  5. Copyright Use & Distribution License:
  6.  
  7. This license covers ONLY the CardShark Bridge Tutor program and Level I course
  8. files. Level II and higher course files and any bonus course files may not be
  9. copied except for personal use and backup by the original licensee.
  10.  
  11. You should have received this program free from a friend or BBS or for a
  12. low fee through a shareware disk vendor for evaluation purposes only. You
  13. may use the program for a reasonable evaluation period. Payment to the
  14. author of the program is required for use beyond simple evaluation. See the
  15. order form at the end of this file.
  16.  
  17. This program may be copied for others to try, so long as no changes are
  18. made to the program nor any of the accompanying files, including this one,
  19. and ONLY if you write to the author for permission. Vendors who are current
  20. members in good standing of the Association of Shareware Professionals must
  21. still notify the author that you are distributing the program, but you do
  22. not have to wait for permission to begin distribution.
  23.  
  24. VENDORS and BBS's must agree to stop distributing this program when requested
  25. or automatically if your membership in A.S.P. is dropped for any reason.
  26.  
  27. CSBT is written in Visual Basic. The Visual Basic runtime module,
  28. VBRUN100.DLL, is Copyright by Microsoft Corp.
  29.  
  30. CARDSHARK BRIDGE TUTOR, CARDSHARK HEARTS and the CARDSHARK card game name
  31. prefix are trademarks of Nelson Ford, PsL.
  32.  
  33.  
  34. Overview:
  35.  
  36. The CardShark Bridge Tutor (CSBT) is a program that can read and display CSBT
  37. course files.
  38.  
  39. Level I is made up of 5 courses, 4 on bidding and 1 on play.
  40.  
  41. Level I courses assume that the user knows nothing about the game of bridge.
  42. When defining terms and concepts, every effort has been made not to use any
  43. other terms and concepts that have not already been defined.
  44.  
  45. The goal of Level I is for the user to learn enough about the game to be able
  46. to play socially with other novice to intermediate level players.
  47.  
  48. The courses are -
  49.  
  50. L1-BID1.CSC - Introduction to Bridge; Opening Bids
  51. L1-BID2.CSC - Responding to Opening Bids
  52. L1-BID3.CSC - Rebids In Non-Competitive Bidding
  53. L1-BID4.CSC - Competitive Bidding
  54. L1-PLAY.CSC - Basic Declarer Play and Defense
  55.  
  56. Each course is divided into lessons with frequent review questions to
  57. reinforce learning.
  58.  
  59. Level II courses and above are not shareware and may be purchased only from
  60. the author using the order form included with these files.
  61.  
  62.  
  63. Registration:
  64.  
  65. The Level I registration fee of $25 is for more than the Level I courses. It
  66. is also for the CardShark Bridge Tutor program, for which many more courses
  67. are available, with more to be developed in the future.
  68.  
  69. The CSBT program is similar to the mechanical AutoBridge device which costs
  70. over $30, but CSBT is much more flexible.
  71.  
  72. In addition, CSBT lets you write your own course files. You could, for
  73. example, write a course for your own bidding system for review or for training
  74. a new partner.
  75.  
  76.  
  77. Installation:
  78.  
  79. To install, simply create a directory for the files in this set and copy the
  80. files into the directory.
  81.  
  82. You can run the program using File Manager or using Program Manager's Alt-F &
  83. Run menu selections.
  84.  
  85. You can add the program to Program Manager using the Alt-F menu options.
  86.  
  87. The program requires VBRUN100.DLL, the Visual Basic runtime module. Because of
  88. the large size of that file and because it is widely available by itself,
  89. VBRUN may not have been included with this program.
  90.  
  91. If you cannot find a source for VBRUN100.DLL, you may get it on disk for $5
  92. from the address or phone numbers on the order form.
  93.  
  94.  
  95. Running CSBT:
  96.  
  97. After starting CSBT, click the button to load a course.
  98.  
  99. The lessons in the course will be displayed.
  100.  
  101. You can start with the first lesson and work through other lessons, or you can
  102. select lessons individually.
  103.  
  104. The CSBT program itself is pretty simple to use. If you do need any kind of
  105. assistance, call the technical support number shown on the order form.
  106.  
  107.  
  108. Answering Questions:
  109.  
  110. When entering answers to questions, use the following abbreviations to help
  111. assure that your answers will match the program's:
  112.  
  113. For suits, use the first letter. (C, D, H, S). Use NT for notrump.
  114.  
  115. Use Dbl and Rdbl for Double and Redouble.
  116.  
  117. For bids, do not leave spaces between the number and the suit. (eg: 1NT, 2S)
  118. Enter "P" for "Pass".
  119.  
  120. For cards, use one-letter: A, K, Q, J, T, 9... etc.
  121.  
  122. For cards and suits, omit spaces: AS = Ace of Spaces. TD = Ten of Diamonds.
  123.  
  124. For a range of points, use the format: "6-9".
  125.  
  126. For an open ended range: "10+".
  127.  
  128. Less than some number: "<10".
  129.  
  130. For Yes/No questions, use the first letter (y or n).
  131.  
  132. Case does not matter. "Y" is the same as "y".
  133.  
  134. If you feel sure you have entered the right answer but the computer tells you
  135. to try again, just click continue.
  136.  
  137. *******************************************************************************
  138. *******************************************************************************
  139.  
  140. [If you are not interested in creating your own bridge training course files,
  141.  you can skip the rest of this file up to the (ahem) Order Form.]
  142.  
  143.  
  144. Making Your Own Course Files:
  145.  
  146. If you are an experienced bridge player, you may wish to make customized
  147. course files for CSBT, you can easily do so with any editor that can save in
  148. straight text ("ASCII").
  149.  
  150. You might wish to make up a course to cover your own bidding system and give
  151. it to a new partner or use it for reviewing yourself.
  152.  
  153. Please remember that CSBT is copyrighted and that if you give a copy to
  154. someone to use (as opposed to passing it along for someone to try out), either
  155. you or the recipient must pay the license fee of $25 for the program.
  156.  
  157. However, you MAY distribute courses for CSBT without the program itself
  158. without any kind of license fee, but you must clearly identify at the start of
  159. the course that you have written the course file and that you have no
  160. connection with the author of CSBT.
  161.  
  162. If you want to distribute a large number of copies of the CSBT program with
  163. your own course(s), call or write for a volume license agreement.
  164.  
  165. Versions of CSBT are available both for Windows and for DOS.
  166.  
  167. *********************
  168. Course File Structure:
  169. *********************
  170.  
  171. The following is the simple structure used to create course files:
  172.  
  173. 1st line: Title
  174. 2nd line: Blank
  175. 3rd line: Start of the Index
  176.  
  177. The Index section ends with a line containing two slashes ("//") followed by a
  178. blank line and then the line with the first lesson title matching exactly the
  179. title line in the Index, except that it must end with a colon.
  180.  
  181. You do not HAVE to have an index entry for every lesson if you do not wish to.
  182. The user can get to such lessons by clicking Continue when in a prior lesson.
  183.  
  184. A lesson can extend over several screens. A large font is intentionally used
  185. so that the user is shown only small chunks of information at a time. This
  186. should make it easier to read, comprehend and remember the information.
  187.  
  188. To indicate the end of a screen full of data, put a line with "//" on it
  189. followed by a blank line.
  190.  
  191. When CSBT hits a line with "//", it looks forward two lines to see if that
  192. line ends with a colon. If it does, it assumes that the line is a new lesson
  193. title and displays "<End of [current lesson name]>" at the bottom of the
  194. current screen; otherwise, it displays "<continued>" at the bottom of the
  195. screen.
  196.  
  197. Because of the proportional font used by Windows, there is no way to know how
  198. much data you can get on a screen, nor (due to the limitation of the
  199. programming tools used) is there any way for the program to detect when the
  200. screen is full.
  201.  
  202. Therefore, you have to experiment. With CSBT in one window and a text editor
  203. in another window, you can go back and forth between the two to make sure that
  204. everything fits as it should. You have to reload the course every time you
  205. make a change in the editor.
  206.  
  207. The course must end with "//" on one line followed by a blank line followed by
  208. a line with "[End]" on it.
  209.  
  210. ***************
  211. Displaying Bids:
  212. ***************
  213.  
  214. To enter a bidding sequence, the structure is as follows (in this example, the
  215. bidding starts with South):
  216.  
  217. [Bid,S]
  218. 1S
  219. Pass
  220. 2H
  221. Pass
  222. ???
  223. ..
  224.  
  225. Put N, S, E, or W after the comma in the Bid line to indicate the starting
  226. hand. If you are quizzing the user, put "???" to indicate the position they
  227. are supposed to bid.
  228.  
  229. To add a bid to a previous sequence, put a "+" in place of the comma:
  230.  
  231. [Bid+S]
  232. 2NT
  233. Pass
  234. 3NT
  235. Pass
  236. ???
  237. ..
  238.  
  239. The above sequence will be added to the previous one with "2NT" replacing
  240. "???" in the previous sequence.
  241.  
  242. End the bidding sequence with a blank line. If you are using a text editor
  243. that will save a line with blank spaces on it, be sure to delete the spaces.
  244. There must be nothing on the line.
  245.  
  246. ****************
  247. Displaying Hands:
  248. ****************
  249.  
  250. You can display one or more hands of cards by indicating on the first line
  251. which position it is (eg: "[N]") followed by Spades on the first line, then
  252. Hearts, Diamonds, and Clubs. For a void, put a dash ("-").
  253.  
  254. A blank line terminates the hand for that position. If you forget to put a
  255. blank line, it will mess up the program and/or the display. No permanent harm
  256. is done, but you may have to restart the program.
  257.  
  258. To display only a Spade suit, you can put:
  259.  
  260. [S]
  261. A K x x x
  262.  
  263. However, to display only a Heart suit, you must put a dash for the Spade suit:
  264.  
  265. [W]
  266. -
  267. J T x
  268.  
  269. ******************
  270. Erasing Bids/Hands:
  271. ******************
  272.  
  273. To erase a previous display of hands and bids, put "[Erase]" on a line by
  274. itself.
  275.  
  276. Do not leave a blank line after an "[Erase]" unless you want an extra blank
  277. line to display. (You do not have to put Erase to clear the previous text,
  278. just the hands and bids.)
  279.  
  280. Do not put [Erase] (or anything else) before a lesson title line. All lesson
  281. title lines must be preceded by a blank line and before that, a line with "//"
  282. on it.
  283.  
  284. At the end of each lesson in the course, the previous bids and hands are
  285. automatically erased.
  286.  
  287. If you do NOT put an "[Erase]" line and if not at the end of a lesson, any new
  288. display information will replace the same field of a previous display (eg:
  289. [Bid] or [N]) but leave other fields alone.
  290.  
  291. In other words, if you want to add North's cards to a display of South's
  292. cards, just put "[N]" followed by the cards as previously described.
  293.  
  294. To add a bid to North's already displayed sequence, put "[Bid+N]" and the bid
  295. on the next line. For South, put +S instead of +N, etc. If the last entry for
  296. the specified hand was "???", the question marks will be replaced by the new
  297. bid; otherwise, the new bid will be added on.
  298.  
  299. ************************
  300. Displaying Vulnerability:
  301. ************************
  302.  
  303. To display vulnerability, add a line with "[Vul]" followed by a line with
  304. "Neither", "Both", "E-W", or "N-S". Do not leave a blank line after these
  305. lines unless you want an extra blank line to be displayed.
  306.  
  307. **********************
  308. Using Multiple Screens:
  309. **********************
  310.  
  311. Each screen of text is delimited by a line with "//". A lesson can span
  312. multiple screens.
  313.  
  314. If you display a hand on one screen and refer to it on a following screen, the
  315. hand will not be displayed if the user is using the "Go Back" button to bring
  316. up the second screen from a later screen.
  317.  
  318. To get around this problem, put a "[+]" at the start of the second screen.
  319. When Go Back sees this, it will continue going back until it reaches a screen
  320. without the "[+]".
  321.  
  322. CSBT normally displays everything between two delimiting lines at once. In
  323. other words, it doesn't matter whether you place bids and hands before or
  324. after the text, it will all appear on screen at once, with one exception.
  325.  
  326. ********
  327. Graphics:
  328. ********
  329.  
  330. You can display small BMP graphic files by entering [BMP:filename] on a line
  331. by itself.
  332.  
  333. CSBT expects the BMP file to be in the same directory as the course files.
  334.  
  335. CSBT will replace the bidding window with a graphics window with the named
  336. graphic in it. The graphics window will adjust itself to the size of the
  337. graphic.
  338.  
  339. In Paintshop, you should set the image size to no more than about 1.75"
  340. square.
  341.  
  342. When you no longer want the image displayed and want to get the bidding box
  343. back, enter a line with [BMP:DONE] on it.
  344.  
  345. ***************************
  346. Question & Answer Structure:
  347. ***************************
  348.  
  349. If you have Question and Answer lines, the program will pause until Continue
  350. is clicked before printing the answer (and the rest of the screen). So if a
  351. hand or bid is entered after an answer, it will not be displayed until the
  352. answer is clicked.
  353.  
  354. You can have more than one Question and Answer on a screen and CSBT will pause
  355. before each answer.
  356.  
  357. The format for Questions and Answers is to start the Question line with "Q:"
  358. and the answer line with "A:". The text of the questions and answers may be as
  359. long as you wish.
  360.  
  361. However, you should make the key part of the answer as brief as possible to
  362. help insure that the user's answer will match it if correct.
  363.  
  364. For example, you will notice in the courses that come with CSBT, answers are
  365. usually something like "H." or "1S." or "Y.", etc. Note that the answer must
  366. end with a period. You can put as much text as you want after the period. The
  367. user's answer is only compared to the text up to the period.
  368.  
  369. If you have more complex answers, you should make them multiple choice so that
  370. the user only has to enter one letter or number. For example you could say:
  371.  
  372. Q: Which suit do you normally lead from against Notrump? (Enter "1" or "2".)
  373.  
  374.    1 - Shortest and weakest.
  375.    2 - Longest and strongest.
  376.  
  377. A: 1.
  378.  
  379.  
  380. Load L1-BID4.CSC (or one of the other files) into a text editor to see all of
  381. the above implemented.
  382.  
  383.  
  384.  
  385.  
  386.  
  387.                     CardShark Bridge Tutor(tm)  Order Form
  388.                     ======================================
  389.  
  390.         Date: ____/____/____
  391.  
  392.         (PLEASE PRINT:)
  393.  
  394.         Name: _______________________________________________________
  395.  
  396.         Address: ____________________________________________________
  397.         _____________________________________________________________
  398.         _____________________________________________________________
  399.         _____________________________________________________________
  400.  
  401.         To Register:
  402.         ===========
  403.           License Fee for 1 copy of CardShark Bridge Tutor
  404.             Level I  @ $25.00 ...............................  ______
  405.  
  406.           License Fee for 1 copy of Level II @ $25 ..........  ______
  407.  
  408.           Combined license for Level I and II @ $39.95 ......  ______
  409.  
  410.         To Get Shareware Disks Only:
  411.         ===========================
  412.           Shareware copy of latest Level I @ $5.00 ..........  ______
  413.           Shareware copy of CardShark Hearts @ $5.00 ........  ______
  414.  
  415.         Shipping & Handling on all orders....................    4.00
  416.  
  417.         Sales tax @ 8.25%, if shipped in Texas ..............  ______
  418.  
  419.                 Total .......................................  ______
  420.  
  421.         Disk size preferred: __ 5.25"   __ 3.5" (1.44MB)
  422.  
  423.         Method of Payment: __Check/M.O. __Amex __MC __Visa __Discover
  424.  
  425.         Credit Card Information:  (PLEASE PRINT)    Expir.: ____/____
  426.  
  427.         Name on Card: __________________________  #: ________________
  428.  
  429.         Cardholder's Signature: _____________________________________
  430.  
  431.         Where did you get CSBT? _____________________________________
  432.  
  433.         Mail To:                        Or Call:
  434.  
  435.         Nelson Ford                             Orders:  800-242-4775
  436.         P.O.Box 35705                       FAX Orders:  713-524-6398
  437.         Houston, TX                       Tech Support:  713-524-6394
  438.           77235-5705                    CompuServe Orders:  71355,470
  439.  
  440.